From b618ca8923ec5b932b18313e1a8dad933d5bbdaa Mon Sep 17 00:00:00 2001 From: =?utf8?q?Javier=20Jard=C3=B3n?= Date: Wed, 9 Jun 2010 06:33:10 +0200 Subject: [PATCH] [docs] Added some missing documentation to GdkDnd The docs was removed by error in commit 9399114802846a3878ff3f8d818bd18664285cf4 --- docs/reference/gdk/tmpl/.gitignore | 1 + gdk/gdkdnd.h | 29 +++++++++++++++++++++++++++++ 2 files changed, 30 insertions(+) diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore index 888b6a26b9..a3343cb70c 100644 --- a/docs/reference/gdk/tmpl/.gitignore +++ b/docs/reference/gdk/tmpl/.gitignore @@ -1 +1,2 @@ +dnd.sgml windows.sgml diff --git a/gdk/gdkdnd.h b/gdk/gdkdnd.h index c6a8079d40..2bdf5897cd 100644 --- a/gdk/gdkdnd.h +++ b/gdk/gdkdnd.h @@ -38,6 +38,21 @@ G_BEGIN_DECLS typedef struct _GdkDragContext GdkDragContext; +/** + * GdkDragAction: + * @GDK_ACTION_DEFAULT: Means nothing, and should not be used. + * @GDK_ACTION_COPY: Copy the data. + * @GDK_ACTION_MOVE: Move the data, i.e. first copy it, then delete + * it from the source using the DELETE target of the X selection protocol. + * @GDK_ACTION_LINK: Add a link to the data. Note that this is only + * useful if source and destination agree on what it means. + * @GDK_ACTION_PRIVATE: Special action which tells the source that the + * destination will do something that the source doesn't understand. + * @GDK_ACTION_ASK: Ask the user what to do with the data. + * + * Used in #GdkDragContext to indicate what the destination + * should do with the dropped data. + */ typedef enum { GDK_ACTION_DEFAULT = 1 << 0, @@ -48,6 +63,20 @@ typedef enum GDK_ACTION_ASK = 1 << 5 } GdkDragAction; +/** + * GdkDragProtocol: + * @GDK_DRAG_PROTO_MOTIF: The Motif DND protocol. + * @GDK_DRAG_PROTO_XDND: The Xdnd protocol. + * @GDK_DRAG_PROTO_ROOTWIN: An extension to the Xdnd protocol for + * unclaimed root window drops. + * @GDK_DRAG_PROTO_NONE: no protocol. + * @GDK_DRAG_PROTO_WIN32_DROPFILES: The simple WM_DROPFILES protocol. + * @GDK_DRAG_PROTO_OLE2: The complex OLE2 DND protocol (not implemented). + * @GDK_DRAG_PROTO_LOCAL: Intra-application DND. + * + * Used in #GdkDragContext to indicate the protocol according to + * which DND is done. + */ typedef enum { GDK_DRAG_PROTO_MOTIF, -- 2.30.2